← Back to Main Page

Overview

This section describes the available REST endpoints for searching company information and retrieving metadata about document types and roles.

The main search functionality allows searching for documents related to a company using CVR number with various filters. Additional endpoints provide lists of available document types and role types for use in searches.

Endpoints

SoegVirksomhedCvr

Endpoint URL: soegvirksomhed/cvr

Method

GET

Description

Search for documents related to a company using CVR number with optional filters for document type, role, date range, and pagination.

Input

Query parameters:

  • cvr - CVR number (required)

  • bog - Registry book number (1=Real Estate, 2=Vehicles, 3=Cooperative Housing, 4=Personal Property) (optional)

  • doktype - Document type (optional, default: 'Pantebrev'). See GetDokumenttyper.

  • rolle - Role type (optional). See GetRolletyper.

  • datofra - From date (optional)

  • datotil - To date (optional)

  • sidetal - Page number for pagination (default: 1)

  • antal - Number of results per page (default: 25)

Output

JSON response containing matching documents with company information.

Error handling

Standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /soegvirksomhed/cvr?cvr=15231599&bog=1&doktype=Adkomst&rolle=debitor&datofra=01012000&datotil=01012020&sidetal=1&antal=25 HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

GetDokumenttyper

Endpoint URL: soegvirksomhed/dokumenttyper

Method

GET

Description

Retrieve a list of available document types that can be used in company searches.

Input

None

Output

JSON response containing a list of document types with key-value pairs and registry book numbers.

Error handling

Standard HTTP error codes for lack of access.

Interaction pattern

Query response

Example request:

GET /soegvirksomhed/dokumenttyper HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

GetRolletyper

Endpoint URL: soegvirksomhed/rolletyper

Method

GET

Description

Retrieve a list of available role types that can be used in company searches.

Input

None

Output

JSON response containing a list of role types with key-value pairs.

Error handling

Standard HTTP error codes for lack of access.

Interaction pattern

Query response

Example request:

GET /soegvirksomhed/rolletyper HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*

HarRegistreringer

Endpoint URL: soegvirksomhed/registreringer

Method

GET

Description

Check if a company has any registrations in the system. Can optionally return the result as a PDF document.

Input

Query parameters:

  • cvr - CVR number (required)

  • sompdf - Return as PDF document (default: false)

Output

JSON response indicating whether registrations exist, or PDF document if sompdf=true.

Error handling

Standard HTTP error codes for invalid input or lack of access.

Interaction pattern

Query response

Example request:

GET /soegvirksomhed/registreringer?cvr=15231599&somPdf=false HTTP/1.1
host: nc-dev-xml-api.tinglysning.dk
accept: */*